﻿
                
  
                         ROUTE CREATOR for LSBS and LTBS

                                    By WTLS




ABOUT THIS TXT:

This txt content:
- Description,
- Requirements,
- Main installation,
- Options infos and installation,
- How to use,
- Changelog,
- Credits,
- Notes.





DESCRIPTION:

This is a script that allows you to create custom routes for Los Santos Bus Service and Long Travel Bus Service mods. The routes are only for the Driver Mode.





REQUIREMENTS:

- GTAV Legacy,
- ScriptHookV,
- ScriptHookVDtNet,
- NativeUI (included),
- LSBS or LTBS or both, lastest version.





INSTALLATION:

Put "BS_RouteCreator.dll" and "NativeUI.dll" from the downloaded "Main installation" folder in "scripts" folder.
Put "LosSantosBusService2" folder and "Coach2" folder from the downloaded "Main installation" folder in "scripts" folder.





OPTIONS INFOS AND INSTALLATION:

Livery for the car used in route creation (with LST and Dashound logos):
Open OpenIV and click tools then package installer then choose the downloaded
"BSRC.oiv" from "Optional installation" folder OR right clic the downloaded "BSRC.oiv" and open with OpenIV, install in "Mods" folder.

Custom LCD signs editing (optional):
If you want the bus when riding a custom route to use a custom LCD sign you have to edit it and install it yourself. Here is how to do it:
1. locate the textures file of the used bus using OpenIV: 
   > for LSBS default edition you can only do this for Metro Express and Metro Rapid lines. Max LCD signs textures that can be added are 7 in this one textures file. File location:  mods/update/x64/dlcpacks/bussim/dlc.rpf/x64/levels/gta5/vehicles.rpf/airbus.ytd
   > for LSBS Edition X you can only do this to extra addon bus(es) apart from the bus models used in the Passenger Mode (XD40 model by default). The model must have LCD signs as extras, not as liveries. You know this by spawning the model in the game and some testing using TrainerV (it is explained in the instructions of LSBS Edition X in "Adding custom bus models requirements" section in "How to use" section). Max 10 textures per model. So if you have installed an extra bus model you know its location from installing it. Locate the texture file: [model name].ytd Usually in: (dlc pack name)/dlc.rpf/x64/levels/gta5/vehicles.rpf/
   > for LTBS max textures that can be added is 16. Requires that you have installed the oiv package "LTBS LCD signs" and not "LTBS Vanilla" when you have installed the mod. Texture file location here: mods/update/x64/dlcpacks/bussim/dlc.rpf/x64/levels/gta5/vehicles.rpf/coach.ytd
2. open the textures file and locate the LCD signs in the left list. 
3. Make sure it is possible to add the custom LCD sign. If the LCD signs have black background continue these exact steps of editing from step 4 to 14. If it has transparent background or very dim texture than you have to edit the LCD sign in that exact way.

<start of texture editing>
4. in the downloaded folder "LCD Sign Templates" open and install the files "bus-disply" and "Ozone".
5. create a copy of the image "example sign" and open it with Windows Paint.
6. zoom it until it is clear enough and use a physical ruler to remember the locations of the texts.
7. select all and delete.
8. set background in black.
9. add text, choose the font "OZONE", choose size 96, choose left alignement, choose the color you want.
10. Write the line number and move it to the propriate area, using your remembered coords.
11. add text, choose the font "BUS DISPLY", choose size 44, choose middle allignement, choose the color.
12. write the 1st Terminal name, then new line, 2nd Terminal name. Or whatever name you want. then move it to the propriate area.
13. (optional) resize the entire image to half its width and lenght.
14. save the file.
<end of texture editing>

15. in OpenIV hit "Edit Mode" and open up the textures file of the bus model.
16. locate the LCD signs.
17. rename the created LCD sign image to the same name of the LCD signs inside the texture file + the number. For example if you find a serie of "lcd_sign_1" "lcd_sign_2"... name it: "lcd_sign_(propriate number)". The number depends if you are replacing or adding new.
   > For the default edition of LSBS and LTBS you should add new. For example in the texture file airbus.ytd the last lcd sign in the list is "lcd_sign_13", so you gonna name the created lcd sign: "lcd_sign_14".
   > For the Edition X of LSBS you can replace lcd signs of the extra addon bus model by setting the exact name of the lcd sign that will be replaced.
18. drag and drop the image file in the textures window, choose DXT5 in "Textures format" drop down, click OK.
19. locate the added lcd sign in the list, select it and click properties, and select the same MipMap levels as the other lcd signs textures.
20. click ok, save.

After creating a route enable "Custom LCD sign" and set "Texture ID" to the propriate ID:
> For LSBS default and LTBS the ID of the added LCD Sign is its number in the list in the textures file minus the last number of pre existing lcd signs. In airbus.ytd "lcd_sign_14" is ID 1, "lcd_sign_15" is ID 2, etc.. In coach.ytd "lcd_sign_5" is ID 1, "lcd_sign_6" is ID 2, etc...
> For LSBS Edition X the very first lcd sign in the list is ID 1, the second is ID 2 etc...
  





HOW TO USE:

Go to Dashound Bus Center, you gonna find a dilletante car parked in a corner. Enter it and a menu will pop up. The menu has everything explained.





CHANGELOG:

1.1:
- first release.





CREDITS:

- Alexander Blade,
- Crosire,
- Dev of NativeUI,
- I'mNotMental,
- OpenIV Team.




NOTES!:

Do not reupload and steal our work!

Enjoy!

                                        WTLS 